home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 4: GNU Archives / Linux Cubed Series 4 - GNU Archives.iso / gnu / git-4.3 / git-4 / git-4.3.11 / README < prev    next >
Encoding:
Text File  |  1996-06-06  |  5.3 KB  |  142 lines
  1. --*-text-*--
  2.  
  3.             GNU Interactive Tools
  4.             *********************
  5.  
  6.  
  7. This file documents the install steps that are specific to the GIT
  8. package, as well as some configuration hints:
  9.  
  10.  
  11. 1. The GIT package uses the 'configure' script to guess your system
  12. features.  The 'configure' script was generated from the file
  13. configure.in (available in the package) using the autoconf utility.
  14. To install the GIT package just type:
  15.  
  16.     ./configure
  17.     make
  18.     make info    // don't bother if it fails
  19.     make install
  20.  
  21. If you want to install striped binaries (smaller), type
  22.     make install-strip
  23. instead of
  24.     make install
  25.  
  26. The configure script first checks for the termcap library.  If the
  27. termcap library is not found, some terminfo libraries will be
  28. searched: ncurses, curses, termlib, tinfo, terminfo.  If you want to
  29. change this default behavior and search for terminfo libraries before
  30. searching the termcap library, run
  31.  
  32.     ./configure --with-terminfo
  33.  
  34. instead of
  35.  
  36.     ./configure
  37.  
  38. Note that it is best to use terminfo instead of termcap under HP-UX.
  39.  
  40. For more information about the 'configure' script please read the
  41. INSTALL file in this directory.
  42.  
  43. 2. There are many configuration files in GIT:
  44.  
  45. a. .gitrc.generic - generic configuration file
  46. b. .gitrc.linux   - Linux console configuration file
  47. c. .gitrc.vt100   - vt100 configuration file
  48. d. .gitrc.vt102   - vt102 configuration file (same as vt100)
  49. e. .gitrc.xterm   - xterm configuration file
  50. f. .gitrc.hpterm  - hpterm configuration file
  51. g. .gitrc.aixterm - aixterm configuration file
  52. h. .gitrc.thix    - thix configuration file
  53. .....
  54. etc.
  55.  
  56. When git/gitps/gitview are started, they search a file named
  57. .gitrc.TERM first in the home directory and then in the $(prefix)/lib
  58. directory (usually /usr/local/lib) (see INSTALL).
  59.  
  60. TERM is the value of your 'TERM' environment variable, e.g. vt102; if
  61. TERM=vt102, your configuration file should be .gitrc.vt102.  The
  62. package contains many predefined configuration files but, if you are
  63. using a different terminal type, then you can easily create a
  64. configuration file for it copying and modifying one of them.
  65.  
  66. Put a suitable configuration file in your home directory if you want
  67. to overwrite the default configuration file.  If you don't have a
  68. configuration file for your terminal, .gitrc.generic will be used.
  69.  
  70. If your terminal supports standard ANSI color sequences, set
  71. AnsiColors to ON in the [Setup] section of .gitrc.TERM.  Otherwise,
  72. AnsiColors should be OFF.
  73.  
  74. 3. Create the directories /mnt/fd0 and /mnt/fd1 (for mounting floppy
  75. disks with gitmount (an auto-mount script). This works for Linux, on
  76. other systems it might be different.
  77.  
  78. 4. Read the .gitrc.TERM files to find out how to configure GIT's
  79. colors, keys ...
  80.  
  81. 5.  If you are using termcap and your system has a huge termcap
  82. database, copy the descriptions of your terminal(s) in a file and put
  83. that file into your home directory. After that, set your TERMCAP
  84. environment variable to point to it. If your login name is mike and
  85. the file you have just created is .termcap, you must append something
  86. like this to your .profile :
  87.  
  88.     TERMCAP=/home/mike/.termcap
  89.  
  90. This will speed up GIT at startup.  If you are using terminfo, don't
  91. bother.
  92.  
  93. 6. In order to be able to read the Info documentation you should
  94. append the git.dir file (found in the package) to the file
  95. /usr/info/dir (this works for Linux; on other systems the main Info
  96. directory could be different). This is *NOT* done by 'make install'.
  97.  
  98. 7. Read the info documentation.  The man pages are obsolete.  They are
  99. provided only for those people that don't have info, and just to give
  100. them an idea about what git is.
  101.  
  102. 8. If you want to take full advantage of all git's features, it is
  103. highly recommended that you install the GNU gzip program.  You can
  104. download it from prep.ai.mit.edu (/pub/gnu).
  105.  
  106. 9. It might be a good idee to install the GNU termcap library too. On
  107. some systems it might make a difference.
  108.  
  109. 10. For SCO Unix users: please use -lmalloc when linking git.  See the
  110. PROBLEMS file for more details.
  111.  
  112. 11. For Linux users: you might want to create the special devices for
  113. reading/writing the virtual console memory.  Use the mkvcs script
  114. provided with git.  Be aware that current Linux systems do not change
  115. the owner of these devices at login time as it is usually done for
  116. ttys.  Therefore, mkvcs creates /dev/vcs?[0-8] with mode 0666.  This
  117. is a major security hole on multiuser systems!  It is recommended that
  118. you create these devices only on systems on which security is not
  119. important.  Maybe future releases of the Linux login program will
  120. change the owner of these devices...
  121.  
  122. 12. In order to use per directory .gitaction scripts you should copy
  123. the .gitaction example in the target directories and then modify it.
  124.  
  125. 13. If git appears to be slow, please consider setting TypeSensitivity
  126. to OFF in the configuration files.
  127.  
  128. 14. If your terminal or terminal emulator supports ANSI colors
  129. (color_xterm & rxvt under Linux, aixterm under AIX, xterm under
  130. ULTRIX) you might want to set AnsiColors to ON in the appropriate
  131. configuration file (.gitrc.xterm).  If your terminal emulator does not
  132. support ANSI color sequences, it is best to set AnsiColors to OFF.
  133. Don't use color_xterm under Linux, it has bugs in the color handling
  134. mechanism.  Please see the file PROBLEMS for more details.
  135.  
  136.  
  137. Good luck !
  138. Tudor & Andi
  139.  
  140. ----------------------------------------------------------------------
  141. Please send bug reports to tudorh@pub.ro
  142.